home *** CD-ROM | disk | FTP | other *** search
/ Merciful 2 / Merciful - Disc 2.iso / software / d / digitalsoundsamv3.0d1.dms / digitalsoundsamv3.0d1.adf / c / Sound.doc < prev   
Text File  |  1996-02-03  |  6KB  |  133 lines
  1. *****************************  Sound.doc  ********************************
  2.  
  3.     Sound is copyright (c) 1988 by Richard Lee Stockton, 21305 60th Ave W.,
  4. Mountlake Terrace, Washington 98043, 206/776-1253(voice), but may be freely
  5. distributed as long as no profit is made from its distribution or sale
  6. without my written permission. I call this concept 'FreeWare', you can
  7. call it whatcha want.
  8.  
  9. (INCLUDED ON PERFECT SOUND WITH PERMISSION FROM THE AUTHOR)
  10.  
  11.     I also include the source code, (Manx 3.4/3.6), in the hope that it
  12. will be of benefit to someone in the Amiga programming community. Feel
  13. free to alter it at will, (but at your own risk!). I _would_ appreciate
  14. receiving a copy of whatever it may become, and it is always nice to be
  15. credited, (perhaps just a few lines of glowing tribute.^).
  16.  
  17.               Long Live Leo and All the Little Schwabie's!
  18.  
  19. --------------------------------------------------------------------------
  20.                    ********  DESCRIPTION  ********
  21.  
  22.     Sound will attempt to feed <SOUNDfilename>'s data to the audio device.
  23. It will 'sound' files containing ANY kind of data, (try 'Sound Sound' :-)
  24. and of ANY length. If you have expansion memory, 'Sound' will store data
  25. in FAST ram, and use only 4-5 k. of CHIP ram to actually sound the data.
  26. This is the magic of 'double-buffering'.
  27.  
  28.    If the STEREO flag is turned ON,the data will be split and played in
  29. stereo. Otherwise, identical data is sent to left and right channels
  30. unless limited by the LEFT or RIGHT flags. (You MUST use a L or R flag
  31. if you only want this sound to use only 1 Amiga audio channel).
  32.  
  33.    Perfect Sound (tm) samples in stereo will automatically sound in stereo.
  34. These are the only stereo samples I've seen, so I don't know if the code
  35. used is universal (in IFF) for STEREO.
  36.  
  37.     If called from workbench, (by doubleclicking on a project icon), Sound
  38. will search the 'ToolTypes' entries in the project icon for 'STEREO',
  39. 'CHANNEL', 'CYCLES', and 'SAMPLES_PER_SECOND'. If found, these values will
  40. override any IFF values read from the SOUNDfile.
  41.  
  42.     If called from CLI, over-riding values for STEREO, CHANNEL, CYCLES,
  43. and/or SAMPLES_PER_SECOND may be specified in the command line. (See below)
  44.  
  45.     If no settings for STEREO, CYCLES, CHANNEL, and/or SAMPLES_PER_SECOND
  46. are found, in the file itself or in the calling arguments, STEREO defaults
  47. to OFF, CYCLES to 1, left and right both on, and SAMPLES_PER_SECOND to 10000.
  48.  
  49. --------------------------------------------------------------------------
  50.                         *****   ABORT!   *****
  51.  
  52.    !!! Sound may be aborted by typing <CTRL> 'c' from the keyboard. !!!
  53.  
  54.   If <CTRL> 'c' does NOT abort the sound, click on the Sound 'Status'
  55.       line, (the top line), then <CTRL> 'c' again. 
  56.  
  57. --------------------------------------------------------------------------
  58.                    ***********  USAGE  ************
  59.  
  60. NOTE!!!  'Sound' should be in your 'c' directory, (ie, 'copy Sound c:'),
  61.            before the following USAGEs will work!
  62.  
  63.         USAGE: (from CLI)
  64.  
  65. Sound <filename> [CHANNEL] [STEREO] [CYCLES] [SAMPLES_PER_SECOND] [QUIET]
  66.  
  67.     The filename MUST be the first argument, then the other arguments
  68. may be in any order, or missing. (see below for valid values). Sound
  69. alone will display a USAGE message. Sound will 'sound' the file, then
  70. display the SAMPLES_PER_SECOND (if the file was found) and STEREO if
  71. the sample was played in stereo.
  72.     There is one additional command when called form CLI (or a scriptfile)
  73. QUIET or just q will disable the StatusLine that usually appears on the
  74. top line.
  75.  
  76. (SAMPLES_PER_SECOND=10000 probably means it wasn't an IFF sound file.)
  77.  
  78.     Although maximum CYCLES = 65535, from CLI the maximum is 55.
  79.  
  80.  
  81.         USAGE: (from WorkBench)
  82.  
  83.    Double-'Click' on project icon whose Default Tool is set to 'c:Sound'.
  84.  
  85.      ToolTypes:   STEREO=      CYCLES=      SAMPLES_PER_SECOND=
  86.                   CHANNEL=     SOURCE=      AUTHOR=
  87.  
  88.    Valid Values:  (these values stored in the .info file)
  89.  
  90.        STEREO                ON -   OFF   default=off. Not case sensitive.
  91.                                            File is split left/right.
  92.        CYCLES                 0 - 65535   0 = sound loops until aborted.
  93.                                            Use Abort Button to stop.
  94.        SAMPLES_PER_SECOND  1000 - 65535   greater than 30000 seems to have
  95.                                            no effect, but MAX = 64k.
  96.        CHANNEL            RIGHT or LEFT   (r or l) Useful for effects.
  97.        SOURCE                 any text    Where did this sound come from?
  98.        AUTHOR                 any text    Immortality, if ya want it...
  99.        
  100. --------------------------------------------------------------------------
  101.                  ********  ARGUMENT PRIORITIES  *******
  102.  
  103.    Arguments from CLI or in the WorkBench Icon override any IFF info.
  104.  
  105.               IFF file info overrides the default values.
  106.  
  107.     Defaults: STEREO = off, CYCLES = 1, both CHANNELS,
  108.                    SAMPLES_PER_SECOND = 10000
  109.  
  110. --------------------------------------------------------------------------
  111.                     *********  REVISIONS  *********
  112.  
  113. MAY 1988  -  Initial release.
  114.  
  115. DEC 1988  -  Added multiple icon select, double buffering, QUIET flag.
  116.  
  117. DEC 1989  -  Now shows soundfile name in status bar.
  118.              No longer crashes if all 4 audio channels are already in use.
  119.  
  120. --------------------------------------------------------------------------
  121.                      *******  OTHER STUFF  *******
  122.  
  123.      Included in this arc file are a sample project icon and its related
  124. data file (Sneeze.info and Sneeze) as well as Sound, Sound.c, & this file.
  125. Feel free to design your own icons, any project icon should work. Just
  126. make the Default Tool in the icon 'c:Sound'.
  127.  
  128.      Please try to keep all these files together when distributing as
  129.      every little bit may be of help!
  130.                                           Stay Warm & Enjoy!  - Richard
  131.  
  132. ***************************** Sound.doc **********************************
  133.